Hello!

------------

If you don't have Motif-2.x libraries installed on your computer, you will have to use

the statically linked package versions.

* libc.so.5.4.38 or higher or glibc

* loopback device (lo) is required for C-Forge to communicate with its servers.

-----------------------------------------

If your original Motif library installations were not from RPM packages you will have to to use the '--nodeps' option of 'rpm' utility to install C-Forge with dynamically linked Motif-2.x.

RPM packages are relocatable and you may install C-Forge where you wish using the '--prefix <dir>' option of the 'rpm' utility. The default directory is

/usr/local/lib/C-Forge.

The RPM library dependency check my fail on some older library collections. If this occurs try installing using the --nodeps flag.

---------------------------------------

Packages with 'tar.gz' extensions contain the installation script ('install.sh').

Just extract the file with the following command:

'tar xopzvf C-Forge-xxx.tar.gz install.sh'

and then run

'install.sh C-Forge-xxx.tar.gz'.

During installation you will be asked for a directory where install the package. The default directory is /usr/local/lib/C-Forge. If installation directory already exists then all files in the there will be deleted before by the installation script.

---------------

The 'cforge' command launches the IDE . At this point 'forge_server' should already be running. (Usually 'forge_server' is launched during installation or system startup. Installation procedures add an entry to the '/etc/inittab' to run 'forge_server' automatically.)

While you are installing 'tar.gz' package you will be asked whether you wish to run 'forge_server' via '/etc/inittab'. If you answer 'No' you will have to run 'forge_server' manually before running 'cforge'. (If you run 'forge_server' manually you must specify the '-f' flag). C-Forge reqires two ports for communications with 'forge_server' and editor server.

The defaults are 9090/udp for forge_server and 9095/tcp for the editor server. If these these ports are already in use in your system, you may change the 'forge_server' port with the command line option '-p #' when you run forge_server and in 'C-Forge Options' menu in 'cforge'.

C-Forge uses one environment variable: C_FORGE. It should point to the package directory. This variable is set up by default when C-Forge is launched from the script /usr/bin/cforge.

----------

This is just the beginning! In future releases of C-Forge we will be significantly increasing the "feature set". We plan to add support for:

* Many more languages

* Bug management

* A full-blown project-wide symbol browser/server

* Our own debugger

* RAD GUI development

Many of these are already being developed. If you see a feature thats missing please don't hesitate to tell us - we will try to incorporate it into future releases. Contact links are available at http://www.codeforge.com

--------

* You type "cforge" and get the following error message:

can't execute c-forge (No such file or directory)

WHAT TO DO: You have downloaded the wrong package type for your system. If you have a libc-based system you must download and install the libc package. If you have a glibc-based system you must download and install the glibc C-Forge package.

* Anything out of the ordinary:

WHAT TO DO: look in the log forge_server and editor_server log files. They are located in the C-Forge root directory and are named FORGE_SERVER-#port.log and SMED-#port.log respectively. (example FORGE_SERVER-9090.log)

* You have typed 'cforge' and the main window appears but the environment hangs with

'Wait for Forge Server reply...':

REASON: 'forge_server' isn't running or 'forge_server' was launched with port different from the port configured in 'cforge' and the two can't communicate.

WHAT TO DO: make sure 'forge_server' is running and check that the port number in the 'forge_server' command line matches the port number in 'C-Forge options' dialog in 'cforge'.

* 'forge_server' can't be launched and gives 'Address already in use' error:

REASON: another service in your system is using this port.

WHAT TO DO: try to change the port number both in the 'forge_server' command line option and in the 'C-Forge options' dialog.

* Built-in editor (SMED) wont start.

REASON: editor fails to allocate the ~30 colors it needs to display.

WHAT TO DO: increase your X color depth.

REASON: cforge was not launched via /usr/bin/cforge script and the proper environment variable have not been set.

WHAT TO DO: run /usr/bin/cforge OR set/export the $C_FORGE environment variable to point to the package installation directory.

REASON: the SMED communications port is being used by another service on your system.

WHAT TO DO: Change the Editor Server port in the 'C-Forge options' dialog. Unlike

the 'forge_server' the editor server is launched by 'cforge' (if there is no

running editor server in the system), so you don't have to restart the editor

server, just try opening the editor session again.

--------------

At this point we think it all works ;) However, what may seem obvious to us may not

be to everyone else. If you have problems during installation (or any part of the IDE

for that matter) please contact us through mail. Contact mail links are available

on our home page at http://www.codeforge.com

Back to Contents